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1*0 INTRODUCTION 



1.0 iMiaamiaiioi 



The prograreJBlng language used in this implementation Is COC CYBIL 
Extended. The details of the interface are defined in terms of CYBIL 
structures* 
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1.0 INTRODUCTION 
l.l^SCOP£^QF^0QC0ri£NT^^^^^^^^^^^ 

1.1 ico££«a£.iiaiiy!i£tii 

This document is one of a set of docuraents describing portions of the 
interfaces Htiich are part of the SES Utility Library* A seperatlon has 
been made to simplify documentation efforts and to exemplify the natural 
modularity* 

This document contains information necessary for the understanding and 
use of the Input Output Control CIQC) available through Software 
Engineering Services Utility library ISESUD* 
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1.0 INTRODUCTION 

l.Z ASSQCIAT6D 03CUH|NTS 

Ttie folloiiing docuwents way be referenced In part to obtain a more 
complete understanding of the origint uses and nomenclature associated 
with Input Output Control. 

NO$/V€ ERS 

Language Specification for COC CY8IL (ARH2298I 

ERS for CY8ILI0 CARH2739I 

Cyber 130 System Interface Standard IS2196) 

SBS Procedure Writers Guide CARH2894) 

SES User's Handbook {ARH1833) 

Hessage Generator ERS (SES Internal) 

Hiscetlaneous Routines ERS (SES Internal) 

Command Processor (CP) ERS (SES Internal) 

System Command Language (SCL) ERS ISES Internal) 

SES Processor ERS (SES Internal) 
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1.0 INTRODUCTION 

1.3 MMIMS-CQMi^EMIIQi^S 

The folloNiIng naming conventions have been Imposed upon the IOC and 
reflect upon the SES Ut 1 1 i ty Library interface routines In general* 
Oecknawes are of the form Zpcyxxx wherei 

Z universal SES Identifier 

pc two character interface identifier 

10 Input Output Control 

y type of deck 

I Compass module CIdent) 

? CYBIL procedure reference 

C CY3II constant declaration 

T CYBIL TYPE declaration 

V CYBIL variable declaration 

n CYBIL module 

F CYBIL function 

XXX three characters representing the abbreviated 

descriptive name of the deck (suggestion Is first 

characters of the words composing the descriptive 
name )• 



COMPANY PRIVATE 



1-5 

COC - SOFTWARE EMGINEERINS SERVICES 

07/16/80 
ERS for Input Output Control Interface REVi 6 

1.0 INTRODUCTION 

1.4 iQC.ysASfi 

All procedures described in this document are available for use. 
Common decks are made available by specifying the "CYBCCMN" keynord on the 
SES.SENCOilF procedure. The binaries are available for linking by 
specifying the *CYaCLI3" keyword on the SES.LINK170 procedure. 

Note that more dcurrent copes of IOC routines are generally made 
available in the *•$$$*• catalog as a function of pre-release *ihile a 
release version is found on the "SES** catalog* A complete summary of 
decks updated during pre-release may be obtained from your local SES 
r epr esentati ve. 
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2*0 IOC DESCRIPTION 



2.0 IQa^aiSdSifliQH 



IOC provides the user an Input/output interface to logically 
concatenate input from multiple sources and distribute output to multiple 
destinations* The purpose of the IOC interface Is to centralize the 
control of Input and output streams to and from user command programsf so 
that processing Is invariant with the mode of accessi e*g*> local batchy 
remote batch or interactive. IOC handles only text type data and works 
*iith CY8ILIQ legible files. 
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2.0 IOC DESCRIPTION 

The objectives of the IQC interface are? 
CI) centralize control of input and output for SES lltltity interfaces and 
<2) make the I/O processing invariant with the mode of access. 
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2,0 IOC DESCRIPTIONl 
£•2 PHItOSQPHy^QF^IOC^ 

2.2 £aiLfliQ£ai«a£.ia£ 

IOC is a high leveH Interface to control I/O to CYBILIQ legible files* 
There are two sides to the IOC interface. 

Input is controlled through the lovSlnput.stack. Entry one Is 
associated »! tli standard Input* Entries 2 •« n are associated Mith 
command file (alternate) Input sources opened during program operation* 

Output Is controlled through the io¥$loc.stre4iii_tabi e* It Is composed 
of a list of flies and a matrix of booleans indicating 8 possible stream 
connections to the 8 files* The file list contains control block 
Information for the files. A table is kept for stream names and ordinal 
association* Variables lov$input_stack» iovSioc.stretiii.tabf e and 

iovSstream^map are externally declared and Initialized by 

iop$loc_lni tialize* 

Basic procedure Interfaces are provided to connect/disconnect streams 
and files* open/close Input files* get/put data* and position Input 
files. 

Note that automatic buffer flushing Is done for all CYBILIO files of 
terminal origin* It is expected that I opSioc.teroiinate is used to 
terminate IOC operations by closing IOC files opened by Initialization* 
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3,0 IOC INTERFACES 



3,0 lOa^iHIEBEAaii 



3,1 aiasLEifiiiai:! 

The IOC interfaces are coinposed of tne declarations of the Input Stack* 
Stream Map and Streais Table along with procedure Interfaces to control I/O 
using these structures* 



COMPANY PRIVATE 



3-2 

COC - SOFTWARE ENSINEERING SERVICES 

07/16/80 
ERS for Input Oytput Control Interface REVJ 6 

3.0 IOC INTERFACES 

3.2^oATA *=!;2w^oiisRAN 2^^i2£|;}l^2i!I£!iI«£2ii22!;^ 

3 . 2 a4I4.£L0M-aiiSS AI3>Q£UM£llI«ayi£llI-.£aiiIEIlL 
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3.0 IOC INTERFACES 
3.3 aiiI4.1IEU£IiigES 



3.3.1 GENERAL STRUCTURES 

The corafflon decks presented contain Inforjuation which forms the basts 
for the higher level structures In the next sections. 



C ZIOTLNG Definition of command file line limitations. > 

CONST 

i ocSmax.l I ne^number « lOOOj 

TYPE 

i ot$l ine_r ange « .. ioc$max_l i ne^number I 



C ZIOCSOS Definition of the Input stack size, > 

CONST 

i oc$sl2e_of_input_stack « 6^; 



£ ZIOCMSR Definition of input stack limitations. > 

CONST 

i oc$!nax^stack_entry « 6^; 



C ZIOCIOH Definition of stream table diiiiensions. > 

CONST 

i oc$max. stream » 8> 
i ocSmax.f i le « 8| 
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3.0 IOC INTERFACES 
3.3.1 GEMERAL STRUCTURES 



C ZIOCSTH Name constants for the IQC Environment 

CONST 

out^f i I e » •output* * 

log^f lie « ' seslog* » 

cond^streara » •condi ti onal^output** 

di^streaia » *di.outputV# 

log^streani » •diagnostic** 

std^streaia « 'standard'* 

alt^streaw « «alternate*| 



C ZIOCSTQ Definition of Input stack ordinals. > 

CONST 

loc$standard » 1# 
t oc$al ternate » 2} 
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3.0 IOC INTERFACES 

3.3.2 IOC LINE 

A basic structure used tiirougNout IOC Is the line. 



♦callc zoststr 

C ZIQTIOL Definition of the iotSltne structure. > 

TYPE 

lotlltne « record 

Indexs ostSstr i ng^lndex* 
length: ost$string_l ength* 
texts string C oscSroax.str I ng^l ength)> 
recendj 



index current position pointer within the text string 

length length of text string 

text buffer containing the string of characters which 

cofgpose a line 
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3,0 IOC INTERFACES 
3«3«3^IHPUT^STACK^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

3.3.3 INI>liT STACK 

The Input Stack provides a structure to handle input sources to a 
program. The first entry of the stack is reserved for standard input* 
Entries 2 through iocSslze^of. stack are used for alternative input 
sources* On exhaustion of input or exit frois that source the former frame 
is restored. 



*cal I c zi ocsto 
♦cailc pxiotyp 
♦callc zioting 
*callc zostnam 
*cal I c zi otiol 

C ZIOTSKF Definition of the Input stack frame. > 

TYPE 

I otSstack.fr ame » record 

pointer.to.f I I e5 file* 

file. name? ostSnoslTO^name* 

I i ne.number J iotSI ine.range* 

I i ne.contentss iot$l lne# 
r ecendf 



pointer_to_f I I e 

pointer to cell nhich Mill contain address of file 
control block 

file. name name of file 

llne.nuraber the line number of file that is currently being 

processed 

I ine. contents the line that is currently being processed 
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3.0 IOC INTERFACES 
3, 3*3 INPUT STACK 

The variable Input stack comnon deck is found on deck ZIQVSTK. 



*cal I c zj ocrosr 
♦ call c z i ocsos 

< ZIOVSTK Declaration of the input stack structure. > 

VAR 

iovSinput^stacki CXREFl record 

St ze_of. stacks •• ioc$f»ax_stack_entry» 
entry^in.uses «* loc$«ax_stack^entry» 

frame! arrayCl •• lOcSsi ze_or_input_stack1 of I ot$st ack^fraroe* 
r ecendj 



size_of_stack top of the Input stack (equivalent to the number of 

entr ies) 

entry^in^use the current entry in use in the stack 

frame file description information 
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3.0 IOC INTERFACES 
3.3.4 STREAM TA8LE 



3.3.4 STREAM TA3LE 



The output stream table provides a means of outputting to more than one 
file with a single procedure call. A stream may be associated with up to 
3 files. This type is available on deck ZIOTISM. 



♦callc ziociow 
♦callc zostnam 



I ZIOTISM 



Oefinitlon of the output stream table structure. > 



TYPE 
lots 

CO 

11 



s t r e am_t able » r ec or d 

nnectss packed arrayCl .. locSmax.streaml of packed arrayCl 
i ocSmax.f i I e3 of boolean^ 
stJ arrayCl .. i oc$iBax_f i I el of record 
pointer^to.fHe? file* 
file^name? ost$nosl70_namef 
connect.count 5 «• i oc$max^stream# 
r ecendf 
recendj 



connects 



list 



this field contains a boolean map representing the 

connections currently established. The rows represent 

possible streams and the columns represent possible 

connections for a stream. 

TRUE indicates an established connection 

FALSE indicates the absence of a connection 

this field contains the fifes currently connected to 
streams. The fife control block and file name are 
maintained for each file connected together Hith a 
count indicating the number of streams to which the 
file is currently connected. 
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3.0 IOC INTeRFACES 
3*3.^ STREAM TABLE 

The Stream Table Is available as a variable in deck ZIOVISM. 



C ZIOVISN Declaration of tfie stream table* variable > 

VAR 

Coutput control> 

i ovSioc.stream^tables CXREF1 lotSstr eaw^tabl ej 
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3,0 IOC INFERFACES 

3,3«5 STREAN^MAP ^^ ^^^«»»««^ .^^^-^^ •^^^ 

3.3.5 STREAM MAP 

The ioySstrean.iiiap Is used to relate the stream names to the relative 
ordinal positions in the Stream Table. 



C ZIOVSTM Declaration of the stream map variable. > 

VAR 

iovSstream.maps CXREF1 arrayCl •• loc$max^stream3 of ostSnamei 



The array of stream names Is established by the connect procedure. 

When an empty entry or the name is found In the array* Its position 

becomes the stream ordinal. The coftneets field in the 

iov$loc.stream^tabl e is set TRUE for that file. A disconnect sets the 
connects field false for that file. 
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3.0 IOC INTERFACES 
3.4 £EQSL£liyE£S 



3^4.1 INITIALIZE IOC ENVIRONMENT 

The purpose of this procedure is to initialize the IOC environment. 
This is executed once per program and must be executed before any of the 
foliOMing procedures way be used. The iov$lnput^stac4c» 

loy$iiic^strea»_tablef and i9v$strea«_iiap are initial i zed and some basic 
stream connections are made. For general purpose use* the initialization 
handles any stream-fife connections necessary for IOC operation. 



C ZIOPINI Initialize the IOC environment. > 

PROCEDURE CXREF3 lop$i oc.i nl t i al ize ALIAS •zioplni* CVAR status? 
ostSstatus); 



status variable Into which status is returned 
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3,0 IOC INTERFACES 

3,4.2 CONNECT FILE/STREAH 

The purpose of this procedure is to establish a connection between a 
file and a stream for output use. When this procedure is called the map 
field of the stream connection is altered to indicate the connection. The 
file is physically opened for output. Note that the default character set 
on open is ascii612#. 



{ ZIOPCFS Connect the file to a stream, > 

PROCEDURE CXREF3 iop$connect_file_to. stream ALIAS •ziopcfs* (file^nameJ 
string (♦ II 
stream^ string { * Ij 
VAR status^ ostSstatus); 



file^name specifies the name of the file to be connected. If the 

file does not exist an error condition will result, 

stream the name of the stream to be connected 

status variable into which status is to be returned 
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3.0 IOC INTERFACES 
, 3.4,3 DISCONNECT FILE/STREAM 

3.4.3 DISCONNECT FliE/STREAn 

The purpose of this procedure is to sever the output connection between 
3 file and a stream. The stream connection table is updated and the file 
is physically closed If no other streams are connected to It. 



C ZIOPDFS Disconnect the file from the stream. > 

PROCEDURE CXREFr lop$dlsconnect^fi le.from.stream ALIAS *2iopdfs* 
Cfile.namex string { ♦ )| 
streams string { * Ij 
VAR status: ostSstatusM 



file. name name of file to be disconnected 

stream name of stream to be disconnected 

status variable into which status is to be returned 
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3,0 IOC INTERFACES 
3«4«4 OPEN INPUT FILE 



3.4.4 OPEN INPUT FILE 



The purpose of this procedure is to open a file for input* The file 
specified becoiaes the current input file* Its description is added to the 
Input control stack and the file is physically opened for Input. Note 
that default character set on open Is ascll6l2i* The fBode way be altered 
by JopScodeset* 

This procedure saves the llne^contefits of the current input file in the 
current stack fraiae before opening the new file. The current stack frame 
Is updated for recall before creating a ne** stack frame* When a source Is 
exhausted the stack Is collapsed* the saved text and position restored* 
This operation occurs during the lopSclose^current.input.f I le* 



^cailc zostnam 
*cai I c zi ot Ing 
* c a 1 1 c z I 1 1 1 



C ZIQPOIF 



Open an input file* > 



PROCEDURE CXREF3 iopSopen.input. file ALIAS *ziopOff* { I i ne.contentss 
i ot$l ine; 

flle^nameJ ost$nosl70_nanie j 
VAR status: ost$statusM 



I ine^contents the current source line to be saved from the stack 



f i le^narae 



status 



f I le* Thi s enab I es 
when the stack is 
that passing a nul I 
buffer contents* 



the text processing 
collapsed back to this 
I ine preserves the 



to continue 
point* Note 
stack frame 



the name of file to be opened* If the file does not 
exist* an error condition results* 

variable into which status is returned 
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3.0 IOC INTERFACES 

3«^*5 CLOSE CURRENT IHRUT FILE 

3,^.5 CLOSE CURRENT INPUT FILE 

The purpose of this procedure Is to close the current Input file. When 
a file is closed by this procedure Its description Is removed frotn the 
Input control stack and the file Is physically closed (unlesss it Is used 
at a lo*ier leirel in the stack). 



C ZIOPCIF Close the current input file. > 

PROCEDURE CXREF1 iopSclose.current^input.fl le ALIAS 'ziopclf' Cstatusi 
ostSstatus }| 



status the variable Into which status Is to be returned 
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3.0 IOC INTERFACES 

3*%.6 SET FltE^CHARACTER^SET^^^^^^^^^^^^^^^^ 

3,4«6 SET FliE CHARACTER SET 

The purpose of this procedure is to set the character set of a teglbte 
file which has been opened by an f opSopen^lfipyt^f i le or a 
iop$eonfiect.f I ie.to.strieaie* Note that for a connect this should be 
executed only once# at the ti«e of the first connection of the file and a 
strean* Care should be taicefi not to attempt to change character sets 
during the course of operations* The default used on all CYBILIO opens Is 
ascii612i. 



C ZIOPCOS Change the character code set of a file. > 

PROCEDURE CXREFl lopScodeset ALIAS 'zlopcds* <f i I e.naflieJ str i ng I * M 
codesetJ flie^encodingj 
VAR status: ost$statusl| 



flle_nai»e specifies name of fife to be set* If the file doesn't 

exist an error condition results* 

codeset corresponds to CYBIIIQ codes ets 

ascli64# 6 bit display code character set 

ascM612# NQS 6/12 character set 

ascii# 8 of 12 ASCII character set 

status variable into vihlch status Is returned 
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3«0 IOC INTERFACSS 

3,4,7 GET COHHA^D LINE 

The purpose of this procedure is to get a cowraand line from the current 
input source* Current source reay be Standard Input or the alternate Input 
source* Each input line Is examined to el Imi nate tr ai I ing blanks* If an 
ellipsis Is found as the last t^o characters of the line continuation Is 
processed* The text line Is built until 256 characters are processed or 
no conti nuati ori Is found* In the event the 256 character rinilt Is 
exceeded abnormal status is set and Input is flushed until no continuation 
is found* When a coaiaand occupies only a portion of the current text line 
a boolean is set true* This indicates a user should repeat the get 
operation to retrieve resnainlng command text In the current line being 
processed* This laay be done after the current command is processed and 
prior to taking any action which would alter stack contents* Multiple 
commands per line assume a semicolon separator* It is the responsibility 
of the user to process the error status as wel I as determine the action 
upon the input source* 



C ZIOPGCL Get the next command line* > 

PROCEDURE CXREF] I op$get^command.i ine ALIAS 'ziopgcM CVAR text? 
i ot$l inel 

\/AR text^r emai ning.l n^l IneJ boolean; 
VAR status* ostSstatus); 

text variable into which next command line Is returned 

text^remal ni ng_ln_l ine 

boolean value is true if current text line contains 
more commands else false if current text line exhausted 

status variable Into which status Is returned 
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3*0 IOC INTERFACES 

3*4,8 GET COHHANO TEXT 

The purpose of this procedure is to get cowflsand text from the current 
input source* This Interface gives the user the abi 1 1 ty to process a 
command greater than 256 characters* Current source may be Standard Input 
or the alternate Input source* Each input line is examined to etlminate 
trailing blanks* If an ellipsis Is found as the last tuo characters of 
the line continuation is flagged via end^of^coanand set to FALSE and 
end.of^lfiput^llne set FALSE* Multiple commands per line assume a 
semicolon separator. It Is the responsibility of the user to process the 
error status as t#ell as determine the action upon the input source* The 
foltoMing table explains actions to be taken on the text line* 



£^i2.i^l S.2^£ Ui££.££iiflQ 









process 


current 





I 


process 


current 


1 





process 


cur rent 


1 


1 


process 


current 



partial commands repeat call 
commands repeat call 
command 
command 



♦callc ziotjol 
"^cal I c osds tat 

C ZIOPGCT Get command text > 

PROCEDURE CXREF3 i opSget^command.text ALIAS 'ziopgct' (VAR texti 
i 1 $ I i n e ; 

VAR end_of_commandt boolean? 
VAR end_of_input_llnei boolean; 
VAR status? ost$status); 

text variable Into which command text Is returned 

end^of.command boolean* true when semi-colon or end of input line 

Indicates end of command * false when continuation of 
being processed* 

end^of.input^l i ne 

the current Input line is completely processed (line 
text exhausted) 

status variable Into which status of this operation is 

returned 
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3,0 IOC INITERFACES 

3.^.9 SET FROH STANDARD INPUT 

3.4.9 GET FROH STANDARD INPOT 

The purpose of this procedure is to get the next fine from the Standard 
Input File. 



C ZIOPGSI Get the next line of input from the standard input file. > 

PROCEDURE tXREFJ I op$get«standard.input ALIAS 'ziopgsM CVAR texts 
lots line I 
VAR status: ostSstatusJl 

text variable into which the next line is returned <note the 

line «ay contain several commands) 

status variable Into which status is returned 
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3.0 IOC INTERFACES 

3.4.10 GET FRQH CURRENT INPUT 

The purpose of this procedure is to get the next record from the 
current {alternate or standard sourcel Input file. 



C ZIOPGCI Get the next line of input from the current Input file. > 

PROCEDURE CXREfl lopSget.current^input ALIAS 'zIopgcM fVAR texti 
i ot$i ine; 
VAR status: ost$status)$ 

text variable into uhlch the next line Is returned (note the 

line may contain several commands) 

status variable into which status Is returned 
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3.0 IOC INTERFACES 
3.4.11 PIIT TO STREAJJ^^^ 

3«4,11 PUT TO STREAM 

The purpose of this procedure Is to output text* When text Is output 
by this procedure it is written on all files connected to the stream 
specified* 



*caHc osdstat 

C ZIOPPTS Send an output string to the IOC stream* > 

PROCEDURE CXREFl i op$put_to_stream ALIAS 'zioppts* (streams string C * >J 
output.text! string < ♦ )J 
VAR status? ost$status)» 



stream the name of the stream to which the text is to be 

output 

output^text the buffer from which the text Is written 

status variable Into which the status is to be returned 
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3.0 IOC INTERFACES 

3«4,12 GET LIME POSITIQM OF CURRENT INPUT FILE 

The purpose of this procedure is to get the line number of the current 
line in the current Input file. 



£ ZIOPSPN Get the line no# of the current line in the current Input 
Cflie, > 

PROCEOURE CXREF3 I opSget^pos i t i on ALIAS 'zlopgpn* CVAR I i ne.nuinber i 
i ot$l i ne^r angej 
VAR status! ost$status>l 

llne^number name of the variable Into which the line number is to 

be returned. The position returned is the line number 
of the last line obtained from the file. 

status variable Into iihich status Is to be returned 
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3.0 IOC INT£Rt=ACES 

3.^*13 POSITIQM CURRENT INPUT FItE TO LINE 



3.4.13 POSITION CURRENT INPUT FILE TO LINE 



The purpose of this procedure is to set the current input file to the 
specified line number. 



C ZIOPSPN 



Set the current input fiie to the specified line number. > 



PROCEDURE CXREF3 iop$set_position ALIAS •ziopspn* < I ine^number s 
i ot$l i ne_r angel 
VAR status: ostSstatusI; 



line. number the line number to which the file is to be set 
status variable Into >*hlch the status Is to be returned 
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3. ^.l^ CURRENT INPUT FILE IS A TERMINAt? 



3.4.14 CURRENT INPUT FILE IS A TERHINAL? 



The purpose of this procedure is to deteriaine if the current input file 
IS of teriBlnal origin* 



C ZIOPFIT Determine if the file is a terminal* > 

PROCEOURE CXREFiT iopScur rent.input.f H e^ter mi nal ALIAS Vziopfit' IVAR 
f i I e_ i s _a_ te r in i n a I J boolean)! 



f i I e.is.a^terialnal 

boolean set true if current file at top of stack is of 
terminal origin else set false 
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3.4.15 CURRENT INPUT EltE MARK 

3.4.15 CURRENT INPUT FItE MARK 

This procedure determines the CYSILIO file mark of the current Input 
file. 



C ZIOPFLH Determine the present mark for the file. > 

PROCEOURE CXREFI iop$current.input«f II e^mark ALIAS •zlopflm* (VAR fsarks 
f I le^warkl ; 



mark the CYBIIIQ file mark of current input source 
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3.^#16 TERMINATE IOC OPERATION 



3.4.16 TERMINATE IOC OPERATION 



This procedure ter(»inates operation of tlie IOC interfaces. The streams 
connected at Ini ti ai izat Ion are disconnected closing output files and the 
input stack is col I apsed closi ng any refaalning input files. This should 
be one of the last steps in a program using IOC. Note that any connects 
laade in addition to initialization should be disconnected seperately. 



♦callc osdstat 

C ZIOPTER Procedure to terminate IOC operations* > 

PROCEDURE CXREF3 i opS i oc.ter fflinate ALIAS »2lopter« CVAR status! 
ostSstatusli 



status 



variable which contains status of operation 



COMPANY PRIVATE 



3-27 
COC - SOFiTMARE EMGIMEERING SERVICES 

07/16/80 
ERS for Input Qytput Cofitrol Interface REVs 6 

3.0 COC II^TERFACeS 
3.5 ERROR CONDITIONS 

3.5 £EEai^£fl!iaiIIQtl5 

The following is a list of condition codes associated with IOC. 

C ZIOCECO Brror codes for the IOC Procedures* > 

CONST 

I oc$i nvall d.open * 4000 ♦ !• 
I oc$i nval i d.cl ose « 4000 + 2> 
ioc$non_posi t J onabi e » 4000 ♦ 3* 
i oc$end_of.f i le « 4000 + 4* 
I oc$not_in.s treafli^raap « 4000 -i- 5f 
ioc$stream_tabl e_ful I « 4000 ♦ 6f 
i oc$f I le_not_f ound « 4000 ♦ 7> 
ioc$ac<|uire_proble« » 4000 *• 8* 
i ocSsize^exceeded » 4000 ♦ 9p 
i ocStoken^unknown « 4000 ♦ 10# 
I oc$co«iBand_too_l ar ge « 4000 ♦ llf 
I ocSstack. exhausted » 4000 + 12j 

The following are common decks ZIOVHTO and ZIONriTO containing 
information used In the construction of the osv$tenpiate_array. These 
decks are added to the template array by the SES.GENMAR procedure by 
Including a product code of *I0». 

?? fmt { format :« off ) 11 

VAR 

osvStempI ate_4001 J Cstatlcl string C35) i« 
•^ INVALID OPEN ATTEHPTEO ON FILE-i-PS 

osvStempI ate.4002 s Cstatlcl string (36) t* 
•> INVALID CLOSE ATTEMPTED ON FILE ♦?»* 

osvStempI ate. 4003 s Cstatici string (29) J« 
•^- FILE *? IS NON-PQSITIONABLE«* 

osvStempI at e.4004 t tstatic3 string (37) :» 
•♦ END OF FILE ENCOUNTERED FOR FILE ^P • » 

osv$template.4005 J Cstatici string (37) 5« 

•^- ENTRY FOR FILE ♦? NOT IN STREAH NAP»# 
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3,0 IOC IMTERFACES 
3«5 ERROR CONDITIONS 



osy$te»pl ate. 4006 J Cstatlcl string <22) 2« 
»4- STREAH TABLE IS FULt«# 

osvStempI ate.4007 s tstaticj string C19) i* 
•* FILE +P NOT FOUND* > 

osvStefflpI ate_4^008 s C s tat icl string 130) s« 
«* THERE MAS AN ACQUIRE l>R08L£M«f 

osy$tefflplate_4009 5 Cstaticl string C21) «« 
«♦ TABLE SIZE EXCEEDED** 

osv$tefflpl ate.4010 s Cstatlcl string <44) s« 

•+ TOKEN RETRIEVED FROM INPUT LINE IS UNKNOWN*, 

osvltempl ate. 4011 i CstaticJ string (19) s« 
«^• CONNAND TOO LARGE** 

osv$te«pl ate.4012 s Cstatici string 123) i« 
»+ INPUT STACK EXHAUSTED* I 

CONST 

osc$2lO¥«t0.count » 12J 
?? fat { format i« on ) ?? 



?? flit ( format :» off ) ?? 

C4001# oscSerror.status 

14002* oscSerror. status 

E4003f oscSerror.status 

£4004* osc$error. status 

C4005* osc$error. status 

C4006> oscSerror. status 

£4007* oscSerror. status 

£4008* oscSerror. status 

£4009* osc$error. status 

£4010* oscSerror. status 

£4011* oscSerror. status 

£4012* oscSwarning.stat 

?? fmt { format «« on ) ?? 



* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
us* 



osv 
'osv 
osv 
'osv 
osv 
osv 
'osv 
osv 
'osv 
'osv 
'osv 



Stemp 
$temp 
Stemp 
$tetiip 
$te«p 
Steffip 
$temp 
Stemp 
Itetap 
Stetip 
Stefflp 
sv$te 



1 ate 
late 
i ate 
f ate 
t ate 
I ate 
t ate 
late 
iate 
late 
I ate 
inpi a 



.40011 
.40021 
.40031 
.40041 
.40051 
.40061 
.40071 
.40081 
.40091 
.40101 
.40111 
te.40121* 



COMPANY PRIVATE 



07/16/80 



Table of Contents 



1.0 INTRODUCTION . . . 

1.1 SCQf>€ OF OQCUHENT • 

1.2 ASSOCIATED OOCOMEHTS 

1.3 NAHING CONVENTIONS 
1.^ IOC USAGE ..... 






1-1 

1-E 
1-3 
1-4 
1-5 



2.0 IOC DESCRIPTION . 

2.1 OBJECTIVES OF IOC 

2.2 PHIIOSOPHY OF* IOC 



2-1 
2-2 

2-3 



OF INPUT OUTPUT CONTROL 



3.0 IOC INTERFACES . 

3.1 DESCRIPTION ... 

3.2 DATA FLOW DIAGRAM 

3.3 DATA STRUCTURES ........ 

3.3.1 GENERAL STRUCTURES .... 

3.3.2 IOC LINE ........ 

3.3.3 INPUT STACK ....... 

3.3.4 STREAM TABLE ....... 

3.3.5 STREAM MAP ........ 

3.4 PROCEDURES ••..«.••• 

3.4.1 INITIALIZE IQC ENVIRONMENT 

3.4.2 CONNECT FILE /STREAM . . . , 

3.4.3 DISCONNECT FILE/STREAM . 

3.4.4 OPEN INPUT FILE ..... 

3.4.5 CLOSE CURRENT INPUT FILE 

3.4.6 SET FILE CHARACTER SET . 

3.4.7 GET COMMAND LINE .... 

3.4.8 GET COMMAND TEXT .... 

3.4.9 GET FROM STANDARD 

3.4.10 GET FROM CURRENT 

3.4.11 PUT TO STREAM . 

3.4.12 GET LINE POSITION OF CURRENT INPUT FILE 

3.4.13 POSITION CURRENT INPUT FILE TO LINE . 

3.4.14 CURRENT INPUT FILE IS A TERMINAL? . . 

3.4.15 CURRENT INPUT FILE MARK ....... 

3.4.16 TERMINATE IOC OPERATION ....... 

3.5 ERROR CONDITIONS ....•.....••. 






INPUT 
INPUT 



* . 



3-1 

3-1 

3-2 

3-3 

3-3 

3-5 

3-6 

3-8 

3-10 

3-11 

3-11 

3-12 

3-13 

3-14 

3-15 

3-16 

3-17 

3-18 

3-19 

3-20 

3-21 

3-22 

3-23 

3-24 

3-25 

3-26 

3-27 



